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PREFACE 



This publication is divided into four sec- 
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multiterminal tasks and MTT application 
programs . 

Section 2 describes how to establish an 
MTT Administrator, use the MTT command, 
and create a multiterminal task. 

Section 3 explains how to write an MTT 
application program. 
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SECTION 1: INTRODUCTION 



MTT (multiterminal tasks) use several system control programs and 
tables that, in effect, transform a standard TSS/360 task, which ser- 
vices only one terminal, to a multiterminal task that can service many 
terminals. A specially designed program, executed as part of a multi- 
terminal task, can provide unique services to those terminals; this pro- 
gram is an MTT application program. 

WHAT IS AN MTT APPLICATION PROGRAM? 



It is a program designed to perform some unique function for many 
concurrent users. These users are connected only to the MTT application 
program; they are not connected to TSS/360, at that time. However, the 
application program runs under TSS/360 and it can use any commands or 
macro instructions available to TSS/360 users. Also, use of a special 
set of MTT macro instructions (READQ, WRITEQ r FREEQ, FINDQ, CLEARQ, and 
WAIT), within the MTT application programs, allows them to perform I/O 
operations directly on the user's terminals. 

WHY CREATE A MULTITERMINAL TASK? 

One reason might be to allow a specific program to interface directly 
with many remote terminals. Users connected to an MTT application pro- 
gram can get quicker responses than those connected to TSS/360 tasks. 
MTT is not subject to the usual system overhead; the system performs 
normal overhead only on a single task, instead of one task for each ter- 
minal as in TSS/360 processing. 

WHO CREATES A MULTITERMINAL TASK? 

A multiterminal task can be created only by an MTT administrator who 
| issues the MTT command Che is a user joined to TSS/360 with an O 
authority code and the T privilege class) . Execution of the MTT command 
transforms the MTT administrator's task (previously established when he 
issued a LOGON command) to a multiterminal task and activates the MTT 
application program. The application program need not be coded by the 
MTT administrator, but only he can attach it to the system and execute 
it. Since the considerations in writing application programs will usu- 
ally require that they be executed by the more experienced programmers, 
execution of the MTT macro instructions is restricted to programmers 
| with authority. * 

USING AN MTT APPLICAT ION PROGRA M 

Connection to an application program can be made by switching the 
terminal to ON and immediately issuing the BEGIN command. If the ter- 
minal is already connected to TSS/360 (i.e., a LOGON had been issued), 
LOGOFF must be issued prior to BEGIN. 

If two users switch on their terminals at 10:30, their sessions might 
proceed like this; 



Introduction 



Page of GC28-2034-1, Issued September 30, 1971 by TNL GN28-3184 



USER A 
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1 
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10:51 



LOGON 



TSS/360 



LOGOFF 



User A connects to TSS/360 as a standard TSS/360 task by issuing LOGON; 
User B connects to a multi terminal task application program oy issuing 
BEGIN. User A can enter any TSS/360 commands at his terminal; User B 
can enter only commands defined by the MTT application program that he 
is using (e.g., APOFF, "application off," is such a command). When User 
A terminates his TSS/360 task and connects to the same MTT application 
program as User B, he may enter only the application program commands. 
When both subsequently complete their use of the MTT application program 
(by issuing APOFF) , they may log on as standard TSS/360 tasks and issue 
TSS/360 commands. 

The format of the BEGIN command will depend on specific application 
programs' requirements for input parameters (see also Command System 
User's Guide ) . 

Subsequent communication between the application program and the ter- 
minal users is carried on by commands or procedures that will have been 
defined in the individual application program. Standard TSS/3 60 com- 
mands entered at an application program user's terminal are meaningless 
unless that application program was coded to accept that command. 



Documentation Requirements 

It is imperative that the creators of MTT application programs pro- 
vide detailed documentation for the program's users. This documentation 
should define the functions of the application, any BEGIN command para- 
meters required as input, and any other commands for user-communication 
with the application program. 



APPLICATION PROGRAM PROCESSING 

Each application program can provide unique processing for its users. 
It may operate as a desk calculator or as a message switching center for 
many remote points. It may simply retrieve specified records from their 
storage locations and display those records at the users* terminals. 

Regardless of function, all application programs will have some simi- 
lar processing steps. For example, all will locate terminals requesting 
service, define and process command input formats for user -interaction 
with the application program, and define users 1 disconnection 
procedures - 

Since TSS/360 does not control MTT users' terminals, the application 
program must serve as the control. The command set that an application 
program might define to allow its users to perform simple calculating 
operations are demonstrated here: 

Command Operands 

BEGIN application name, userid, chargeno 

ADD expressionl,expression2 

SUBT expressionl, expression2 

MULT expressionl f expression2 

DIV expressionl, expression2 

APOFF none 

(BEGIN and its first operand are processed by the system (see Command 
System User's Guide ) f but the userid and chargeno must be defined and 
processed by the MTT application program. The APOFF command must also 
be processed by the application program.) 

Users of such a calculator program would have only these six defined 
commands. They enter BEGIN to start using the calculator functions of 
the application program at their terminals. Then they continue with 
their calculations by using ADD f SUBT, MULT f and DIV. When the applica- 
tion program performs the calculations and prints the results at the 
user's terminal, the user can issue the APOFF command and return to his 
desk with the results. 



I nt r oduc ti on 



SECTION 2: CREATING AND ADMINISTERING MTT 



INITIALIZATION 

Before activating a multiterminal task (via the MTT command) , a sche- 
dule table entry must be established for the table-driven scheduler (see 
the System Logic Summary ) under which the multiterminal task is to start 
its execution. This entry should be designed and incorporated into the 
system either by the MTT administrator or by an experienced system pro- 
grammer. It can be incorporated into the schedule using a delta data 
set during system startup (see System Generation and Maintenance ) . 

The selected schedule table level will set the internal environment 
in which the multiterminal task will execute (although it may dynamical- 
ly change during the task's execution) and it will specify if there is 
to be page stealing. Since different MTT applications have unique 
storage requirements (i.e., size, residency requirements, etc.), the 
page stealing gives the user greater flexibility in establishing the 
internal environment for operating his MTT application program. Page 
stealing permits a subset of the task's pages to be purged to a drum 
when the task has accumulated the maximum storage pages specified in the 
schedule table. 

The multiterminal task will be subject to the same drum-to- disk 
migration algorithm that controls normal TTS/360 tasks. 



THE MTT COMMAND 

When he issues the MTT command, the MTT administrator must specify 
the number of users that will be allowed concurrent use of the applica- 
tion program, and the buffer requirements for each terminal. He must 
also specify the name of the application program and the schedule table 
entry level that was set up during initialization. The application pro- 
gram is activated when the MTT command is executed; the MTT administra- 
tor's terminal keyboard is then locked. Any further interaction between 
the MTT administrator and the application program must be predefined in 
the application program (see "MTT Administrator's Interaction with App- 
lication Programs"). 

Two unique tasks may issue the MTT command specifying the same appli- 
cation program. Thus, several copies of an MTT application program may 
exist concurrently. In this environment, connecting user terminals will 
be attached to the copy with the least number of active lines regardless 
of any user ID or charge number specified in a BEGIN command. When two 
copies of an application program are active, users should be aware that 
they have no control over which copy of the application program they 
will be connected to. For certain application programs, multiple copies 
can be helpful when the application is required to perform large quanti- 
ties of VAM I/O and I/O overlap is desired. 



MTT — CREATE A MULTITERMINAL TASK 

The MTT command converts a normal TSS/360 task to a multiterminal 
task that can service a large number of remote terminals. This task can 
be executed either conversationally or, if it is not necessary for the 
application program to be conversational, in the background as a batch 

task. 
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r T . 1 

| Operation | Operand | 

j. + . .- -I 

| MTT I PROG=raodule name , MAX L= number , LEVEL= number j 

I I I 

| | [ , BUFSIZ=number] | 

L JL . J 

PROG 

specifies the name of the application program to be executed. This 
parameter is required, it consists of one-to-eight alphameric 
characters. 

MAXL 

specifies the maximum number of lines (i.e. f terminals) that may be 
simultaneously connected to the program. The number n must be 
0<n<4095. This parameter is required. 

LEVEL 

specifies the schedule table level at which this task is to start. 
The number n must be < n < 255. This parameter is required. 

BUFSIZ 

specifies the length in bytes of the buffer to be associated with 
each terminal line connected to an application program. The size 
of this buffer determines the maximum byte-length of an input mes- 
sage. The number n must be 16 < n < 4080. 

Default : 200 

Functional Description 

The MTT command processor verifies that the issuing user has an O 
authority code and a T privilege class. Then an attempt is made to 
load the application program. Input parameters are checked; any invalid 
parameters are prompted for and rechecked. When all parameters are 
validated, the application control blocks, necessary for the operation 
of a multi terminal task, are established. The blocks are the applica- 
tion terminal control table CTCT) , the application multi terminal status 
control block (MTSCB) , and its buffer pages. The MTT processor reserves 
virtual storage space needed for the application TCT and buffer pages, 
issues a CHANGE macro instruction to pass control to the specified sche- 
dule table level, invokes supervisor services (via a CONN macro instruc- 
tion) to create the resident application MTSCB, and then explicitly 
calls the specified application program. 

If a task is already multiterminal, when the MTT command is issued, 
the task is disconnected from its current application program by the 
FREEQ ALL and DCON macro instructions. CONN is then reissued to connect 
the task to the currently specified application program. Thus, if an 
MTT administrator issues two MTT commands at his terminal, only the last 
will remain active. If the MTT administrator hits the attention key, 
and then issues a second MTT command for the same application program, 
thereby reactivating the application program, any external interruption 
servicing routine previously established — via SIR and SEEC macro 
instructions — due to the initial activation of the application pro- 
gram, is still in effect. 

When a normal return (i.e. , via a RETURN macro instruction) is made 
from the application program, the MTT processor unloads the program and 
issues a FREEQ (ALL, message- addr) . This releases the application's TCT 
and buffer slots, and informs all terminals connected to the application 
program's task: "APPLICATION TASK TERMINATED OPERATION" and "TERMINAL 
LOGICALLY DISCONNECTED, RECONNECT OR HANG UP." Each terminal line is 
placed in a read-state similar to the status of an initial connection. 

Creating and Administering MTT 5 
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After getting sucn a message, every terminal user has two minutes to 
enter BEGIN or LOGON, or hang up the phone; if there is no action in 
that time, the terminal will be physically disconnected. 

Then a DCON SVC is issued to clean up storage; the task is returned 
to the original schedule table level; the remaining application TCT page 
and buffer pages are released; the application MTSCB is erased; and con- 
trol returns to the command system. 

Then the MTT administrator's SYSIN/SYSOUT terminal receives an under- 
score; the administrator may LOGOFF or proceed as a normal TSS user. 

ABEND AND LOGOFF ACTIONS 

If a multiterminal task goes through an ABEND or LOGOFF procedure, 
warning messages will be sent to any active users of the MTT application 
program: 

For ABEND 

"APPLICATION TASK ABEND 98 

"TERMINAL LOGICALLY DISCONNECTED, RECONNECT OR HANG UP" 
For LOGOFF 

"APPLICATION TASK LOGOFF" 

"TERMINAL LOGICALLY DISCONNECTED, RECONNECT OR HANG UP" 

In either case, the terminal users have two minutes, as in a normal 
application return, to enter LOGON or BEGIN, or hang up the phone. 

EXAMPLE : An MTT administrator logs on to TSS/360, causing a standard 
task status index (TSI) to be created. When he subsequently issues the 
MTT command, his TSI is converted to a multiterminal task TSI (i.e., the 
TSIMTT flag is set on) ; control is passed to the specified application 
program. The MTT administrator's terminal keyboard remains locked while 
the application program is processing (see "MTT Administrator's Interac- 
tion with Application Programs"). 

User: LOGON USEREJB 

System: B001 LOGON TASKID00014 11/14/69 13:08 

System: 

User: MTT MODULE, 3 00, 13 , 255 

MTT ADMINISTRATOR'S INTERACTION WITH APPLICATION PROGRAMS 



Interaction between an MTT application program and its MTT adminis- 
trator must be defined and provided in the application program. For 
conversational multiterminal tasks, the MTT administrator's keyboard is 
locked when the MTT application program is activated; interaction can 
only be initialized by: the MTT administrator hitting his attention 
key, or the application program issuing macro instructions that pass 
control to the administrator's terminal (e.g., GATRD, GTWSR, CLIC, CLIP, 
etc.) . 

When the attention key is pressed on the administrator's SYSIN/SYSOUT 
terminal, while an application program is running, an asynchronous 
interruption will be queued on the multiterminal task's TSI. It is pro- 
cessed by normal TSS/360 interruption-handling facilities. The applica- 
tion program can process this interruption by creating an asynchronous 
interruption-servicing routine, using SIR, SAEC, and USATT macro 



instructions, or by use of the AETD macro instruction. The 
interruption-servicing routine can then prompt the MTT administrator's 
terminal for what he wants the application program to do. That program 
can then interpret the administrator's reply accordingly. The adminis- 
trator might want to shut down the application, deactivate particular 
users, or write messages to all connected terminals • Note that while 
the application program is communicating with the MTT administrator, via 
the SYSIN/SYSOUT terminal, it appears dormant to its users; it will not 
be able to perform processing for them. If the MTT application program 
is running as a batch task, it can provide combined administrator/ 
operator functions through one of the connected terminals. This allows 
concurrent communication between the application program, the adminis- 
trator, and the application program's users. 

If no attention-handling routine has been defined in the application 
program, the attention will be processed by TSS/360, and the MTT admini- 
strator's terminal will be prompted for additional input via the stan- 
dard TSS/360 prompting characters (_ I or -•). The MTT administrator 
can then enter TSS/360 commands or resume application program 
processing. 
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SECTION 3: WRITING AN MTT APPLICATION PROGRAM 



When a multi terminal task is initially dispatched by the system, 
because the MTT administrator issued the MTT command, its application 
program receives control. At this time, no users should have been con- 
nected to the program. Thus the application program might begin by 
going through an initialization procedure (e.g., opening all data sets 
that comprise the application service program) . When initialization has 
been completed, the application program should search for users who may 
subsequently have been connected (by their use of the BEGIN command). 
The program locates initially connected users by one of two processing 
techniques: the polling mode or interruption mode. 



INTERRDPTION MODE PROCESSING 

Because initial connections are unsolicited, the system automatically 
queues an external interruption with message-number 127 (see "Processing 
External Interruptions") on the application task. When the interruption 
is subsequently processed, control is passed to any interruption- 
servicing routine defined in the application program. If no routine has 
been defined, the interruption will be ignored; then any initial connec- 
tions can be detected only by the polling mode. 

POLLING MOPE PROCESSING 

A slot in the application TCT is assigned to each connecting termin- 
al, A flag in that slot will be set to denote initial connections; this 
is done whether or not an interruption- servicing routine has been estab- 
lished. The FINDQ macro instruction can be issued to poll the applica- 
tion TCT (see "Polling the TCT"). If no terminal has been connected to 
the application program, or if no connected terminal desires to do any 
work, the program should issue the WAIT macro instruction, after which 
it will remain idle until there are subsequent requests for services. 

SUBSEQUENT COMMUNICATION WITH USER TERMINALS 

After locating the initially connected terminals, an application pro- 
gram must communicate with those terminals to determine which of its 
services the terminal user wants to use. The READQ, WRITEQ, and CLEARQ 
macro instructions should be used for this communication. The applica- 
tion program can use READQ and WRITEQ to elect the polling mode or 
interruption mode. 

I/O Processing 

When application programs issue read or write requests to user ter- 
minals, buffer areas are allocated and I/O buffer slots are created for 
each request in the buffer page tables. These buffer areas and slots 
are later released. Buffers for read operations can be released, fol- 
lowing completion of the input operation, by issuing a CLEARQ macro 
instruction or another I/O operation; buffers for write operations are 
released automatically on completion of the write operation. 

Upon completion of any I/O operation, the TCT slot for that device 
will be posted to indicate work completion. Also, if the READQ/WRITEQ 
interruption option was selected, completion of an I/O operation will 
cause an external interruption to be queued on the application task. 



For completion of read operations, the virtual storage address of the 
input buffer slot is passed to the application program in a parameter 
list (i.e., either in the FINDQ parameter list, DSECT CHAFNQ, or the 
terminal interruption parameter list, DSECT CHATII). 

Note that issuing READQ and WRITEQ causes the requested I/O operation 
to be initialized and control to be returned to the application program 
before completion of the operation. 

I/O Completion 

If processing of an application program depends upon the completion 
of a previous I/O operation, the program must verify that the I/O opera- 
tion has been completed before continuing the processing. The verifica- 
tion can be done in either the interruption mode or the polling mode, 
similar to intial connection processing. 

1. If the READQ or WRITEQ interruption option was selected, the appli- 
cation program can write an external interruption-processing rou- 
tine (via SIR and SEEC macro instructions) that will automatically 
receive control upon completion of a terminal I/O operation (see 
"Processing External Interruptions") . 

2. A FINDQ macro instruction can be issued to poll the application TCT 
table for terminal slots that have the work- completion indications 
set in the work flag (see "Polling the TCT"). 



PROCESSING EXTERNAL INTERRUPTIONS 

The application program can process external interruptions by estab- 
lishing an interruption- processing routine through issuance of the SIR 
and SEEC macro instructions. All external interruptions generated by 
the system for processing by an application program will have external 
message-number 127 associated with them? when the application program 
issues a SEEC to assume control, it must specify the external message 
number 127 to identify the type of external interruption to be 
processed. 

This interruption-servicing routine will automatically receive con- 
trol whenever an external interruption with message number 127 is 
generated for a terminal connected to the application task. When the 
routine receives control, the address of an interruption control block 
(ICB), containing the address of the interruption processor's communica- 
tion area, will be in register 1 (see the SIR and SEEC macro instruc- 
tions in Assembler User Macro Instructions for more on these parameter 
areas) . 

The message area address, in the second word of the communication 
area, points to the message control block (MCB) that contains terminal 
interruption information. The three-word interruption message can be 
located at a displacement of 16 from the beginning of the MCB and has 

this format: 

DSECT CHATII 

r . _ T . j 

| relative line no. | input message length | 

t J i 

+ 4 1 address of input message | 

+ 8 | work mask | device type | symbolic device address) 
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Work mask Meaning 

message in, complete 

1 message out, complete 

2 attention 

3 initial connection 

4 unrecoverable error 

5 negative response to polling for 1050 

(component not ready) 

6 buffer overflow 

Device type 

(binary no,) Meaning 

1 1050 

2 2741 (correspondence keyboard) 

3 2741 (PTTC/8 keyboard) 

4 teletypewriter 

When an external interruption option has been specified for a line, 
it remains in force until a subsequent READQ or WRITEQ is issued against 
that line to indicate that interruptions are not desired. 

If SIR and SEEC are used, the application program must issue DIR 
before terminating interruption servicing. This assures that the multi- 
terminal task is properly initialized with regard to interruption 
requests. 

Mixed-Mode Processing 

If an application program is operating with mixed-mode processing 
(i.e., both interruption and polling modes), any interruption- servicing 
routine should also issue a CLEARQ macro instruction to the terminal it 
is servicing. That will clear the work flag in the TCT slot associated 
with the terminal and ensures that the same condition will not be pro- 
cessed by subsequent FINDQ macro instructions. 

Inhibiting Interruptions 

Prior to issuing any MTT macro instructions (within an interruption- 
processing routine), the application program should disable task inter- 
ruptions via the SAI macro instruction; the program should enable inter- 
ruptions via the RAE macro instruction upon return. This must be done 
because the MTT macro instructions are not recursive unless issued with 
a unique save- area pointer and a unique parameter list. 

If the specified interruption-processing routine issues any MTT macro 
instruction, except WAIT, and does not inhibit interruptions, it must 
provide a unique save area (pointed to by register 13) and use a unique 
parameter list to avoid possible recursion (automatic if S-form is 
used). This will preserve task integrity, since an interruption may 
have occurred during execution of a macro instruction. 

POLLING THE TCT 

When the interruption mode is not used, the application program must 
poll the terminals' slots in the application TCT for those that have 
initial connections or their work flags on. Issuing a FINDQ macro 
instruction will detect and present any initially connected terminals, 
or I/O completions, by polling the TCT slots. In addition to return 
codes in register 15, execution of FINDQ returns, in register 1, the 
address of a f ullword pointer which contains the address of a parameter 
list (DSECT CHAFNQ). This parameter list contains the relative line 
number assigned to the terminal being processed, the device type (e.g., 
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1050/2741), and the buffer address. The relative line number roust be 
used by the application program to address each user's terminal. The 
first terminal connected to an application program would be relative 
line number 0000, the second 0001, etc. The application program can 
process any input message at the indicated buffer address. When the 
message has been processed, the buffer can be released for further use 
by issuing a READQ, WRITEQ, or CLEARQ macro instruction. If one of 
those macro instructions is issued while an I/O operation is in pro- 
gress, a busy condition will be returned to the application program? any 
buffer associated with the operation will be preserved. 



DISCONNECTING USERS 

Each connected terminal's TCT slot is permanent for the duration of 
an active application program, unless a FREEQ macro instruction is 
issued against that terminal by the application program. Application 
programs must define the means by which current users may elect to be 
disconnected. Upon receiving a defined disconnect message, the applica- 
tion program can issue a FREEQ to that device, logically or physically 
disconnecting the terminal and freeing the TCT slot. 



ADDITIONAL APPLICATION PROGRAMMING CONSIDERATIONS 

Data Translation/Processing 

During normal I/O operations (with the READQ and WRITEQ macro 
instructions) , the system will translate incoming and outgoing text by 
using the appropriate translation table: PTTC , correspondence, or tele- 
typewriter (see Terminal User's Guide for character-translation tables) . 
Alternatively, the application program can, on an individual basis, 
specify translation and provide its own translation table. The MTT 
macro instructions perform no editing whatsoever. Carrier returns, idle 
characters, tabs, and backspace characters must be supplied and pro- 
cessed by the application program. These standard translations will be 
performed: 

1050 PTTC/8: EBCDIC 

27 41 PTTC/8: EBCDIC 

27 41 CORRESP: EBCDIC 

teletypewriter ASCII: EBCDIC 

Ail lower-case alphabetic characters will be converted to upper-case. 

Input-Message Editing : When "message in, complete" is noted in a ter- 
minal's TCT slot, the message area and message count includes all chara- 
cters (e.g., backspaces and carrier returns), except EOB, EOT, and XOFF, 
for the 1050, 2741, and teletypewriter terminals respectively. 

Function Symbol EBCDIC code 

carrier return (new line) 
end of block 
idle (for output only) 
end-of -transmission 
transmitter off 

Output-Message Editing : All messages transmitted via the WRITEQ macro 
instruction may be followed by an ending seguence: 
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CRCNL) 


X'lS* 


EOB 


X , 26 i 


IL 


X , 17 f 


EOT 


X f 37 f 


XOFF 


X'13 1 



Device Ending sequence 

1050 CR 

2741 CR f IL (approximately one IL for every ten 

characters) 

teletypewriter none Call reads or writes automatically prefixed 

with carrier return and line feed) 

On 1050 and 2741 terminals, the carrier return (CR) at the end of the 
WRITEQ message may be omitted. Then subsequent write operations will 
continue on the same line until the end of the printer line is reached. 

For 1050 terminals, whether carrier returns have been specified in 
the output line or the carrier is returned automatically, writing con- 
tinues "on the fly" as the carrier is returning. Idle characters (IL) 
should be included to allow the carrier to complete its return. 

Additional information describing terminals and their character 
translations is in Terminal User's Guide , 

Attention- Interrupt! on Handling 

The two sources from which attention interruptions may be generated 
are: the MTT administrator's terminal and any application- prog ram 
users' terminals. 

From the MTT administrator's terminal, an attention interruption 
allows him to interrupt the program's processing and request the program 
to interact with him, or request interaction between him and the users 
of the application program (See also "MTT Administrator's Interaction 
With Application Programs"), When the administrator is communicating 
with the application program, via the SYSIN/SYSOUT terminal, users of 
the application program cannot make use of it; they remain in a wait 
status until the administrator returns control to the application 
program. 

From an application- program user's terminal, pressing the attention 
key causes that terminal's application TCT entry to be posted with an 
attention indication. The user can elect (via READQ and WRITEQ) , for 
all his attention-key requests, to have an external interruption with 
message number 127 (see "Processing External Interruptions") queued on 
the multiterminal task's TSI. If the application program has defined an 
interruption-servicing routine, using SIR and SEEC macro instructions, 
the program responds to these external interruptions in the defined 
manner. If there is no defined interruption-servicing routine, the pro- 
gram can service interruptions only by polling. 

The method used in polling, to detect attention interruptions, 
depends on whether the interruption occurs during a READQ, WRITEQ, or 
CLEARQ to a terminal, or while the application program is doing other 
work. 

If the attention key is pressed during execution of a READQ or 
WRITEQ, the I/O operation will not be initialized; the attention indica- 
tor in the terminal's TCT entry will be cleared. The attention inter- 
ruption will, however, be indicated in a return code to the application 
program. If the attention interruption occurs during a CLEARQ opera- 
tion, that operation will be completed, the attention interruption indi- 
cator in the TCT entry will be cleared, and a return code indicating the 
occurrence of an attention interruption will be passed to the applica- 
tion program. 
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If the attention interruption occurs while the application program is 
performing work for another user, or while it is in the WAIT state, 
detection of the interruption should be handled differently. Then a 
FINDQ must be issued to poll the TCT for the interruption. When only an 
indication of an attention interruption is posted in the TCT entry, the 
interruption can be processed readily, based upon the FINDQ return code. 
However, if an I/O completion for a read or write also occurs and the 
TCT i£ posted with two settings, one for an attention interruption and 
one for the I/O completion, the FINDQ return code recognizes only the 
I/O completion. The attention interruption is recorded in a field 
(FNQATN) in the FINDQ parameter list (DSECT CHAFNQ) . The application 
program must examine the parameter list after all I/O completion 
returns, if it is to process these attention interruptions. 

Reading and Punching Cards (IBM 1050 system only) 

Application programs can define commands that, when entered at a user 
terminal, will direct the application program to perform READQ and 
WRITEQ operations on card readers and punches attached to a 1050 system 
(see READQ and WRITEQ macro instructions). Thus, application- program 
users could have data sets read in from, or punched on, a card 
reader /punch . 

TSS/360 Commands from an Application-Program Users' Terminals 

An application program can act as a middleman between its users and 
TSS/360 by reading in TSS/360 commands, issued at the users' terminals, 
and then passing them on to the TSS/360 command system via the OBEY 
macro instruction. In most cases, this is undesirable because of the 
extra overhead. However, for some TSS/360 commands (i.e., generally 
those that perform no terminal I/O, such as DDEF) , an application pro- 
gram might utilize the command system on behalf of its users. 

Using a Terminal's Hardware Break-Option 

Use of the WRITEQ macro instruction's break option implies the exis- 
tence of a hardware break-feature on the specified terminal. If the 
break option is specified to a terminal that does not have the hardware 
feature, results are unpredictable. When the break option is specified, 
WRITEQ will interrupt any I/O operation that is in progress to the ter- 
minal and write the specified message out at that terminal. Any inter- 
rupted I/O operation is terminated. 

Use of DSECTs 

Detailed descriptions of DSECTs, for the control blocks used in a 
multiterminal-task environment, are found in System Control Blocks or in 
the TSS/360 macro library, ASMMAC. 

Other Coding Considerations 

Application programs should be written as nonprivileged code. Pro- 
grammers with an O- authority, can issue an LVPSW macro instruction to 
transfer to the privileged state, to take advantage of the privileged 
system macro instructions. 

The user should be aware that nonconversational rules of the system 
apply to multiterminal tasks executed in the background. Thus, some 
instructions that can only be executed conversationally, will be ignored 
when issued nonconversationally. 
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SECTION 4: USING MTT MACRO INSTRUCTIONS 



The formats and descriptions of the MTT macro instructions (CLEARQ, 
FINDQ r FREEQ, READQ, WAIT, and WRITEQ) use standard TSS/360 format nota- 
tion and value mnemonics. The reader is assumed to be familiar with 
these standards. A table of value-mnemonic equivalents is in Appendix 
B. Assembler User's Macro Instructions includes detailed descriptions 
of the operand forms. 

All MTT macro instructions reside in the ASMMAC macro library; a DDEF 
must be issued before assembling any of them. Dummy sections (DSECTs) 
referenced in this section are described in System Control Blocks . 



CLEARQ — CLEAR TERMINAL DEVICE STATUS (S) 

The CLEARQ macro instruction clears any indications of pending work 
for a terminal device and releases data buffers that were assigned to 
that device in a previous READQ operation. 

r T T . — ., 

I Name | Operation | Operands | 

| (symbol] | CLEARQ (relative line number- value | 

L -L X . . J 

relative line number 

specifies the relative position of the entry (or slot) in the app- 
lication's terminal control table (TCT) associated with the termin- 
al for which any indication of pending work is to be cleared. The 
number must be in the range of 0-4095 and specify an active TCT 
slot. When register notation is used, the (binary) device number 
must be loaded into the two low-order bytes of the specified 
register before issuing CLEARQ. 

The relative line number can be found in either (A) the paramet- 
er list generated by a previous FINDQ (addressability to this list 
can be established by using, as a base register, the pointer that 
is pointed to by register 1 and the DSECT CHAFNQ or (B) the com- 
munication area of any external interrupt ion- processing routine 
that may have been written by the application program (see "Proces- 
sing External Interruptions"). 

INITIALI ZATION ; The address of a save area must be placed in register 
13. 

CAUTION ; This macro instruction may be used only in a multiterminal 
task (MTT) application program. 

EXECUTION : When the CLEARQ routine receives control, register 1 points 
to a pointer parameter-list (which contains the relative line number) in 
the issuing program's PSECT. This parameter list is described by DSBCT 
CHACLQ. CLEARQ checks the entry (or slot) in the application TCT, 
pointed to by the specified relative line number. The associated device 
number is tested for validity? if valid, the status byte of the applica- 
tion TCT slot is examined for work indications. If any READQ or WRITEQ 
is in progress, a busy signal is returned; no clearing functions are 
performed. Otherwise, the routine will save the contents of the TCT 
slot work byte for the device and reset (clear) the byte to 0's. 
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The slot is also checked for a buffer that is assigned to the device. 
If there is a buffer, a clear request will be set in the slot and an 
ATCS system macro instruction will be issued. This will cause TCS to 
release that buffer slot. Return data will be passed to the application 
program, based on the saved work byte indications. 

Return Data : The low-order byte of register 15 is set to 

Code Significance 

normal return 

04 invalid relative line number (not connected to application 
program) 



08 
0C 



busy, previous READQ or WRITEQ not completed 

attention interruption received; normal clearing functions 
performed 



PROGRAMMING NOTES : Any of these pending-work indications in an applica- 
tion TCT slot can be cleared using CLEARQ: 

• initial connection completed 

• attention received from device 

• solid I/O errors on line 

• message in, complete 

• message out, complete 

CLEARQ should be used when some conditions are signaled by an extern- 
al interruption and others by a setting in the application TCT slot 
(mixed mode processing). Example: If initial connections are processed 
by an application program f s interruption-servicing routine, but FINDQ is 
used to poll for subsequent transactions on that device, CLEARQ should 
be issued to clear the initial- connection indication to prevent a subse- 
quent FINDQ from reprocessing that same indication- 
Normally, buffer space assigned to a device is released automatically 
by subsequent executions of READQ or WRITEQ with the response option. 
If those macro instructions are delayed, for whatever reason, CLEARQ can 
be used to release buffer space. 

Use of L- and E-Forms : The L-form macro instruction results in a macro 
expansion that consists only of a parameter list. The name field is 
mandatory in the L-form; in the E-form it is used to locate the paramet- 
er list. Use of L- and E- forms: 

LFORM CLEARQ MF=L relative line no. not specified 

EFORM CLEARQ ( 5) , MF= (E, LFORM) relative line no. in register 5 

EXAMPLE : In mixed-mode processing, an application program is processing 
initial connections from terminals via an external interrupt ion- handling 
routine and subsequent transactions to those terminals by using FINDQ. 
When an initial connection occurs, generating an external interruption 
and posting the indication in the application TCT slot, control passes 
to EXTINT for appropriate processing. Before the interruption routine 
completes its processing, it issues CLEARQ to clear the initial- 
connection indication from the application TCT slot to prevent a subse- 
quent FINDQ from reprocessing that indication. 

Assume SIR and SEEC macro instructions have been previously issued in 
an application program to establish EXTINT as the routine that is to 
process initial connections. When EXTINT receives control, a pointer to 
an interrupt control block (ICB) is in general register 1. The inter- 
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ruption routine might perform appropriate processing such as checking 
the initial-connection BEGIN parameters • 



EXTINT 



mask off interruptions, save registers 
under standard linkage conventions 



L 


2,0(1) 


L 


3,16(2) 


DROP 


CURREG 


USING 


CHATII,3 


L 


4,TIIWWK 


L 


5,TIIRLN 


L 


6,TIIVMA 



CLEARQ (5) 



get address of COMAREA from ICB 

get address if MCB ♦ 16, the buffer 
address 

drop current base register 

establish base register for terminal- 
interruption information DSECT, CHATII 

locate TCT work flag, using DSECT sym- 
bol, to verify cause of interruption 

get relative line number of initially 
connecting terminal 

get address of input message of initial 
connection 

examine BEGIN parameters in location 
addressed by register 6 

before returning to main portion of 
application program, clear TCT slot 
using register notation format 



allow for interruptions 
RETURN return via standard linkage 

*** interruption-mode processing ends here; polling-mode processing 

*** follows 

POLL FINDQ poll terminals for work 

B ABC (15) branch table using return code 

ABC B NOWORK if no work, enter wait-state; RC=00 





B 


NITERR 




B 


INCOMP 


NOWORK 


WAIT 

B 


POLL 


NITERR 


- 




INCOMP 


L 

DROP 

USING 


2,0(1) 

REG3 

CHAFNQ,2 




L 


7 , FNQMS A 



POLL 



if FINDQ locates an initial connection, 
that is error condition that should 
have been processed by the EXTINT 
routine; RC=08 

if previous READQ completed, process 
input, perform requested service 



wait to be redispatched by system 
when reactivated by system, poll 

application's TCT for work 
perform appropriate error processing 



get address of FINDQ parameter list 

establish base register for FINDQ 

parameter list (DSECT CHAFNQ) 
get address of input message using 

symbols from DSECT 
examine input message at address in 

register 7 to determine required 

service 
when processing is complete, poll TCT 

TCT for more users 
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FINDQ -- FIND TERMINAL REQUIRING WORK (S) 

The FINDQ macro instruction polls an MTT application program's work 
queue (i.e., the application terminal control table entries) for ter- 
minals that require the services of the application program, or option- 
ally, returns the work status of a specified terminal. 

I Name | Operation | Operands | 

j. ._+ — _+ 4 

I [symbol] |FINDQ | [relative line number-value) | 

relative line number 

specifies the relative position of a specific terminal's associated 
entry (or slot) in the application's terminal control table (TCT) . 
It must be in the range of 0-4095. When supplied by the register 
notation, the specified register must contain the (binary) relative 
line number in the two low-order bytes, before issuing FINDQ. 

Default : Circular polling of the TCT? the status of the first ter- 
minal that requires the application program's services will be 
returned. 

Note ; The relative line number specified will usually be the num- 
ber specified in a previous READQ, WRITEQ, CLEARQ, or FINDQ. 

INITIALIZATION : The address of a save-area must be placed in register 
13. 

CAPTION : FINDQ may be issued only in an MTT application program. If an 
MTT application program has established a routine for external interrup- 
tion processing to service initial terminal connections or completions 
of read/write operations, but has failed to issue a CLEARQ macro 
instruction after processing such conditions, a subsequent FINDQ will 
result in reprocessing the connections or completions. 

EXECUTION : If the relative line number is defaulted, FINDQ polls 
entries in the application TCT to locate a terminal that requires serv- 
icing. If no terminals require servicing, the return is to the applica- 
tion program with the appropriate return code. When a terminal requires 
services (i.e., its application TCT entry has the work flag set on), 
FINDQ will clear the work indication from the slot, and pass status 
information and the return codes that describe the type of service 
required to the application program. 

Return Data : FINDQ sets the low-order bytes of register 15. 

Code Significance 
00 no work 

04 invalid relative line number (not connected to application 
program) 

08 initial connection of device 

0C attention received from terminal device 

10 solid I/O error on terminal line 

14 message out, complete (from previous WRITEQ? see also 
"flag byte") 
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118 message in, complete (from previous READQ or WRITEQ/RESP; see 
also "flag byte") 

1C negative response from input component 

J 20 message in (overflowed buffer; see also "flag byte*) 

Also, FINDQ returns, in register 1, the address of a full word pointer 
to this parameter area: 

DSECT CHAFNQ 

[macro instruction control (message length | 

Y x < 

+4 I message-area address | 

k r T < 

+8 [polled relative line number! flag byte (device type) 
+12 I | SDA | 

macro instruction control 

contains relative line number or default code, depending on use of 
macro instruction 

• X'FFFF 1 — relative line number defaulted (polling option) 

• a specific relative line number (binary), in range of 0-4095, 
that is to be checked 

message length 

meaningful only for "message in, complete" (RC=18 or 20) ; contains 
binary number of characters typed at terminal while in read- state 

| message area address 

meaningful only for "message in, complete" (RC=18 or 20); contains 
pointer to buffer area containing an input message typed at termin- 
al while in read-state; if read with translation option, input text 
will be in EBCDIC, otherwise in line-code form. If the attention 
key was pressed (see "flag byte", bit 1), while a read was on the 
terminal's line, the message area contains the data entered from 
the terminal up to the point where the attention occurred - 

polled relative line number 

meaningful only in polling mode; the field contains relative line 
number of terminal ready to work 

The relative line number is assigned to a terminal during its ini- 
tial connection and must be used in all subsequent transactions, to 
identify that terminal. The first connected terminal becomes line 
0000, the second, line 0001, etc. 

flag byte 

these bits are defined: 

bit 0: will be cleared every time FINDQ is used; if in polling 
mode and if resulting scan for work "wraps around" (from 
last terminal to first) , this bit will be set to 1 when 
FINDQ returns 

bit 1: meaningful only for "message in, complete" (return code 

18), "message out, complete" (return code 14), or "message 
in but overflowed" (return code 20); if set to 1, an atten- 
tion interruption has been received from terminal; if an 
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MTT application program, operating in polling mode f is to 
process interruptions, it must examine this bit 

device type 

specifies code indicating the type of terminal requesting service s 

Terminal type 

1050 

2741 (correspondence keyboard) 

2741 CPTTC keyboard) 

teletypewriter 



Hex code 


01 


02 


03 


04 



SDA 



system's "symbolic device address" of terminal 



PROGRAMMING NOTES : If an application program has not defined an 
interruption-processing routine to process external interruptions 
generated at initial connection (and optionally upon completion of reads 
and writes), a FINDQ macro instruction must be issued to detect those 
interruptions and completions, 

FINDQ polls initially at the beginning of the application TCT and, 
subsequently, immediately after the TCT entry on which the previous 
execution of FINDQ stopped. 

Every time FINDQ returns with a "work" indication, the work status of 
that entry is cleared? FINDQ will never return an indication a second 
time when that indication has been previously processed by a FINDQ. It 
will, however, present work-status information a second time, when 
operating in the interruption mode, if CLEARQ has not been used. 

Use of L- and E-Forms : The L-f orm macro instruction results in a macro 
expansion consisting of only a parameter list. The name field is manda- 
tory in the L-form; in the E-form it is used to locate the parameter 
list. Use of L- and E-forms: 

LFORM FINDQ MF=L 

EF1 FINDQ (4),MF=(E,LFORM) 

EF2 FINDQ MF= (E, LFORM) 

The instruction labeled LFORM creates a parameter list in the issuing 
program's PSECT. EF1 inquires about the status of the terminal whose 
relative line number is in register 4. EF2 requests polling mode for 
any terminal requiring service. 

EXAMPLE : An application program polls its applications f s TCT for any 
terminals requiring service. Action is then based on an appropriate 
return code from FINDQ. When no work is found, the application program 
enters the wait-state until redispatched by the system. 

POLL 

branch table using return codes 
ABC B NOWORK no work ready; enter wait- state 

invalid relative line number specified; 

branch to error-message routine 
initially connected terminal requires 

servicing 
attention interruption from specified 

terminal; any outstnading READQ or 

WRITEQ was not completed and must be 

reissued 
solid I/O error on terminal line 
previous output completed from a WRITEQ; 
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FINDQ 

B 

B 

B 


ABCU5) 

NOWORK 
INVNO 


B 


NITCON 


B 


ATTNINT 


B 
B 


IOERR 
OUTCOMP 





B 


INCOMP 




B 


NEGINP 




B 


OVFLO 


NOWORK 


WAIT 






B 


POLL 



INVNO 



continue servicing that terminal (e.g., 

issue subsequent READQ or WRITEQ) 
previous READQ or WRITEQ with response 

completed; process input line 
branch to process negative input value 
input message to long; issue error 

message 



wait to be redispatched upon work 

completion 
when reactivated, poll application's 

TCT for work 



FREEQ — DROP A TERMINAL DEVICE (S) 

The FREEQ macro instruction causes a terminal associated with the 
specified relative line number (or all terminals) to be physically or 
logically disconnected from an MTT application program. It will also, 
optionally, write a message to that terminal before disconnecting. 



r T T . 1 

| Name | Operation ( Operands | 

[symbol] J FREEQ | (relative line number-value^ 
I I (ALL { 



I f message pointer-addr] 
.disconnect- 



r / PD n 

I f disconnect-) LP ( ) 



j 



relative line number 

specifies relative position of an entry (or slot), in application 
TCT, associated with terminal that is to be logically or physically 
disconnected; if ALL is specified, all terminals will be discon- 
nected; unless physical disconnection is specified, terminals will 
be logically disconnected. During logical disconnection, a user 
must # within 2 minutes, connect to TSS (i.e., LOGON) or to an appli- 
cation program (i.e., BEGIN). If no action is taken in that time, 
physical disconnection occurs. If register notation is used, the 
(binary) relative line number must be loaded into the two low-order 
bytes of the specified register before execution of FREEQ. 

The relative line number can be found in either (A) the paramet- 
er list generated by a previous FINDQ (addressability to this list 
can be established by using, as a base register, the pointer that 
is pointed to by register 1 and the DSECT CHAFNQ) or (B) the com- 
munication area of any external interruption-processing routine 
that may have been written by the application program (see "Proces- 
sing External Interruptions'"). 

message pointer 

specifies address of pointer to a message area, which must be in 
this format: 

r t t 1 

I length | message text | CR | 

L X . X . J 

1 byte 
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The length, byte should indicate the length of the message plus one 
(for the length byte itself). 

If register notation is used f the address of the pointer roust be 
loaded into the specified register before executing FREEQ. 

disconnect 

specifies logical or physical disconnection; LD or PD should be 
indicated. 

PD specifies that the device, associated with the application TCT 
entry indicated by the relative line number, will be physically 
disconnected from the system; the line to the device will be 
disabled. 

LD specifies that the device will be logically disconnected (i.e., 
all related tables cleared) and a read CCW placed on the ter- 
minal's line. A timer interruption is set for 2 minutes; if no 
subsequent interruption is received from the device before the 
time expires, the device will be physically disconnected. 

Default : LD 

INITIALIZATION : The address of a save-area must be placed in register 
13. 

CAUTION ; This macro instruction may be specified only in a multitermin- 
al task. 

EXECUTION ; When the FREEQ routine is entered, register 1 will point to 
a parameter list pointer (DSECT CHAFRQ) that contains the macro instruc- 
tion parameters. The entry (or slot) in the application TCT pointed to 
by the specified relative line number is examined. The device asso- 
ciated with that entry is checked for validity; if valid, any I/O opera- 
tion to that device will be terminated, and the terminal will be physic- 
ally or logically disconnected from the task. If the message option was 
specified, a message would be written to the appropriate terminal before 
its line is disconnected. If the ALL option was specified, any message 
specified will be written to all connected terminals; all connected ter- 
minal lines will be physically or logically disconnected and all appli- 
cation TCT pages and buffer pages (except one of each of these pages) 
will be released. 

Return Data : Register 15 will be set. 

Code Significance 
normal return 

04 invalid relative line number specified (not connected to 
application program) 

OB should not normally be received by users; indicates 
disconnect byte must be 00 or FF 

0C zero length was specified 

10 illegal use of the L-form of the macro instruction. 

PROGRAMMING NOTES : When logical disconnection is requested, the user 
has the option of becoming a TSS user or connecting to an MTT applica- 
tion program, without having to redial the system. The message "TERMIN- 
AL LOGICALLY DISCONNECTED, RECONNECT OR HANG UP" will be displayed at 
his termminal; he will then have two minutes to respond with a LOGON or 
BEGIN command. 
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When the message option is specified, the message text must be in the 
EBCDIC form. The message will be routed to printer 1 (see "WRITEQ") for 
1050 terminals. Control characters will be inserted by the system where 
necessary. 

The message length specified by FREEQ should not exceed 72 characters 
when being sent to a teletytewriter. 

Assignment of relative line numbers to a device is dynamic, following 
entry of a BEGIN command at a terminal; this assignment continues until 
FREEQ is issued. If a terminal is logically or physically disconnected 
and later reconnected to the same application program, a new relative 
line number probably will be assigned. 

Use of L- and E-Forms ; The L-form macro instruction results in a macro 
expansion consisting of only a parameter list. The name field is manda- 
tory in the L-form; in the E-f orm, it is used to locate the parameter 
list. While the relative-line ALL operand is mandatory, it may be spe- 
cified in either the L- or E-form. Illustrations of using the L- and 
E- forms: 



LF1 
EF1 



FREEQ 
FREEQ 



MF=L 



option left to E-form 



(6) ,MF=(E, LF1) relative line number specified by 
register 6 



EF2 FREEQ ALL, MF=(E f LFl) 

EXAMPLE : An MTT application program processes an input line from one of 
its connected terminals and finds that the terminal has finished using 
the application program. A FREEQ is then issued to the terminal asso- 
ciated with the relative line number in the FINDQ parameter list. The 
message "YOUR APPLICATION LOGOFF IS COMPLETED" is written to the termin- 
al and it is logically disconnected. The user at the terminal can then 
proceed to log on as a normal TSS/360 user, or issue the BEGIN command 
for another (or the same) application program. 



POLL 



ABC 



Locate terminal ready to work 
FINDQ 

B ABC (15) branch to appropriate routine based on 

return code 



INCOMP previous WRITEQ with response com- 
pleted ,RC= 18 



*** Has terminal completed use of application program? 



SR 


6,6 


SR 


5,5 


L 


2,0(1) 


DROP 


CURREG 


USING 


CHAFNQ,2 


L 


5,FNQMSA 


L 


7,1(5) 


C 


7 , APPOFF 



BE 



DISCON 



get pointer to FINDQ parameter list 
drop current base register 
establish base register for DSECT CHAFNQ 
get input message address 
get first word of input message 
compare first word of input with logoff 
code defined in application program 



DISCON LH 7,8(2) get relative line number 
FREEQ (7),QUITMSG 
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AP0FF DC c 1 **** 1 logoff indicator defined in application 

program 
QUITMSG DC ALMQOTTAP) pointer to "quit" message 
QUITAP DC ALKL'MSG) 
| MSG DC C'YOUR APPLICATION LOGOFF IS COMPLETED' 

READQ — INITIATE READ OPERATION TO TERMINAL (S) 

The READQ macro instruction causes the line to a specific terminal 
device to be placed in the read status; control is immediately returned 
to the MTT application program. 

[Name | Operation) Operands | 

I. + „. H __ 4 

[symbol] [READQ [relative line number- valu e [~,TRNSL=j Nil 

I 1 L UfJ 

I I 

1 | [, INTRPT=(Y\] [ r C0MPSEL=value3 

relative line number 

specifies relative line number of entry in the application TCT 
associated with a terminal to be read? when supplied as register 
notation, the specified register must contain the (binary) relative 
line number in the two low-order bytes. 

The relative line number can be found in either (A) the paramet- 
er list generated by a previous FINDQ (addressability to this list 
can be established by using, as a base register, the pointer that 
is pointed to by register 1 and the DSECT CHAFNQ) or (B) the com- 
munication area of any external interruption-processing routine 
that may have been written by the application program (see "INTRPT" 
option below) • 

TRNSL 

specifies character translation option that indicates if a ter- 
minal's character set (or line code) should be translated into 
internal EBCDIC code. If specified as Y, the input line code will 
be translated to EBCDIC using the standard translation table for 
the specific device: 

Device Line code Internal translation 

1050 PTTC/8 (folded) EBCDIC 

27 41 PTTC/8 (folded) EBCDIC 

2741 Correspondence (folded) EBCDIC 

teletypewriter ASCII EBCDIC 

If specified as N, no translation; the input from the terminal will 
be recorded internally in line form. 

Default : TRNSL=Y 

1NTRPT 

specifies external interruptions (with external message number 127) 
are to be generated and queued on the application's TSI on comple- 
tion of this read operation (and after any subsequent I/O opera- 
tions, unless specified otherwise). Y indicates external interrup- 
tions should be generated for processing by the application; N 
indicates no external interruption and that a subsequent FINDQ must 
be issued to locate completed read operations. 
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Default ; initially N; when this option has been changed, however, 
the default thereafter will be either Y or N, depending on the roost 
recently issued READQ or WRITEQ in which the INTRPT option has been 
explicitly specified. 

COMPSEL (for IBM 1050 system only) 

specifies decimal value indicating type of 1050 unit? if register 
notation is used, low-order byte of specified register must contain 
desired value in binary form. 

Value Unit type 

5 terminal keyboard 

6 reader 1 

7 reader 2 

any input component 

Default : COMPSEL=5 

INITIALIZATION : Address of a save-area to be placed in register 13. 

CAUTION ; This macro instruction may be used only in multiterminal task 
(MTT) application program. 

EXECUTION : When READQ receives control, register 1 points to the 
address of a parameter list (containing the READQ input parameters) in 
the issuing program's PSECT. The DSECT, CHARDQ, describes this list. 

The READQ routine examines this parameter list and checks the entry 
(or slot) in the application TCT pointed to by the specified relative 
line number. The associated device number is tested for validity; if 
valid, the status byte of the application TCT slot is examined for work 
indications. If an indication of a pending attention interruption or 
previous I/O operation still in progress is found, return codes are set 
and then control returns to the application program. Otherwise, the 
read request and associated options are posted in the TCT slot and con- 
trol is passed to the terminal communication subprocessor (TCS) via the 
ATCS system macro instruction. When READQ resumes control, it rechecks 
for any attention interruptions that occurred between the first check 
and the issuance of start I/O (SIO) by TCS. If an interruption has been 
received, the I/O will not be initiated; the appropriate return code 
will be passed to the application program. If no interruption was 
entered, an attempt will be made to start the I/O for a channel program. 
If successful, a READ CCW is on line to that device. Control is then 
returned to the application program before processing of the read CCW 
with return code 00 in register 15. 

When the read CCW for a terminal is processed, the terminal will be 
placed in the read status. The terminal user can then enter an input 
line that will be placed (translated or untranslated) into the input 
buffer by the channel operation. When the read operation has been com- 
pleted, the application TCT slot associated with the device will be 
posted as "message in, complete." An external interruption can option- 
ally be queued on the task's TSI. 

Return Data : Control is returned to the issuing application program 
with the low- order byte of register 15 set to 

Code Meaning 

normal return 

04 invalid relative line number (not connected to application) 
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08 busy; previous READQ or WRITEQ not completed 

0C attention interruption received from terminal 

10 solid error occurred during initiation of starting I/O 

The read operation will be initiated by this macro instruction only 
when the return code = 00. For RC=0C f the attention interruption indi- 
cation will be cleared. 

PROGRAMMING NOTES : The implied maximum length of any input message is 
the buffer length specified by the MTT command that enables the applica- 
tion program's task. Characters beyond this length will be truncated. 
The message length and its location are returned to the issuing program 
when the message transmission is complete; they can be found in a para- 
meter list associated either with an external interruption that has 
external message number 127 (DSECT CHATII) or with the FINDQ macro 
instruction (DSECT CHAFNQ) . 

When the translation tables do not apply, an application program may 
apply its own translation function. In such cases the TRNSL=N option 
should be specified; the application translation function should be app- 
lied against the input recorded in the buffer. 

A WRITEQ with a response option is more efficient than issuing separ- 
ate WRITEQ and READQ macro instructions. The application program can 
issue a prompting message and place the terminal in a read state; input 
can then be entered. 

If INTRPT=Y is specified, the application program must use the SEEC 
and SIR macro instructions to set up a routine to service the external 
interruptions indicating completion of read operations. An external 
message number of 127 should be specified with SEEC. See also "Proces- 
sing External Interruptions" under "Application Program Processing." 

Any buffer space assigned by a READQ or WRITEQ to the device asso- 
ciated with the application TCT slot is released automatically by subse- 
quent executions of READQ, or a WRITEQ with the response option. Howev- 
er, if the input data is processed, but further READQ or WRITEQ proces- 
sing is delayed for some reason, the application program can release 
buffer space by issuing CLEARQ . 

Use of L- and E-Forms ; The L-form results in a macro expansion consist- 
ing of only a parameter list. The name field is mandatory in the L- 
form; the E-form is used to locate the parameter list. The only operand 
required is the relative line number, which may be specified as either 
L- or E-forms. 

LFORM READQ MF=L relative line number not specified 

EFORM READQ (5) , MF= (E f LFORM) relative line number in register 5 

EXAMPLE : FINDQ indicates that a previous WRITEQ has just been completed 
to a specific terminal, which should now be ready to furnish additional 
input. Thus, READQ is issued and, if the read is successfully 
initiated, the application program continues to poll its application's 
TCT for additional work. When the initiated read CCW reaches the speci- 
fied terminal, the terminal will be placed in a read-state; the user can 
enter input. When transmission of this input is completed, an external 
interruption will be generated but ignored due to the INTRPT option, and 
the application TCT slot-status byte will be set to indicate the comple- 
tion. Polling via FINDQ will eventually reflect the completion of the 
read operation and the application program can then process the data in 
the input buffer. 
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*** poll terminals for work 
POLL FINDQ 

B ABCC15) 

ABC 



branch to appropriate routine based on 
return code 



B 
B 



OUTCOMP previous WRITEQ completed; RC=14 
INCOMP previous READQ or WRITEQ with response 
completed, RC=18 



OUTCOMP L 2,0(1) get parameter list address 

LH 6,8(2) load relative line number from FINDQ 

parameter list into low-order byte of 
register 6 
READQ (6),Y,N read device associated with relative 

B BRTBLE(15)line number in register 6 
BRTBLE B POLL continue servicing application's TCT 

word queue 

INCOMP B PROCESS service input to application program 

WAIT — WAIT FOR TERMINAL STIMULI (O) 

The WAIT macro instruction temporarily suspends execution of an MTT 
application program pending receipt of an external terminal interruption 
representing work for the task. 



r ■ — t ■ r ' 

I Name | Operation I Operands 

I symbol (WAIT | [environment - A] 

L A L . 






environment 

specifies task in which WAIT was issued as a multiterminal task; it 
should be specified as code A or defaulted. 

Default ; A 

CAUTION : Execution of the WAIT SVC 204 is restricted to tasks having 
authority O or P. 

EXECUTION ; The WAIT routine will check register 0; if it is (indicat- 
ing an MTT task), will locate application's multiterminal status control 
block (MTSCB) pointed to by the issuing task's TSI. It then extracts 
the virtual storage address of the first application TCT page and scans 
the pages for any work posted since the last application- program scan. 
If work has been posted, the task is then redispatched for processing. 
If no work is found, the task's TSI will be placed in a wait-state. Any 
incoming work from an application user causes the system to reactivate 
the application task. 

After execution of the system's posting routines or an application 
program's interruption-servicing routine, in response to a work request, 
control is returned to the instruction after WAIT. 

PROGRAMMING NOTES : If an MTT application program has defined an extern- 
al interruption servicing routine, when subsequent work requests (i.e., 
following entering the wait-state) generate interruptions that routine 
can process the work. Upon return from that interruption routine, pro- 
cessing is continued at the instruction following WAIT. 
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Any interruption the task allows (or enables) , causes the appropriate 
interruption servicing routine to be redispatched. 

EXAMPLE : An MTT application program has polled its users for input and 
has not found any ready to work. Then it issues WAIT to place the app- 
lication's TSI in the wait-state until a user enters a work request. 
Any subsequent requests will be posted in the application program's ter- 
minal control- table slot associated with that user's terminal? TCS will 
redis patch the application program at the next sequential instruction 
following WAIT (i.e., at SEARCH). FINDQ will then poll the application 
TCT a second time and find the posted work indication. Control is 
passed to INC0MP where the work indication can be processed by examining 
the FINDQ parameter list pointed to by register 1. 

poll user's terminals for work 
branch table using return codes 
if no work is ready, enter wait-state 
RC=00 



previous READQ completed, process input 



POLL 
ABC 


FINDQ 

B 
B 


ABCU5) 

NOWORK 




B 


INCOMP 


NOWORK 
SEARCH 


WAIT 
B 


POLL 


INCOMP 


L 

DROP 

USING 


2,0(1) 
CURRER 
CHAFNQ, 



wait to be redispatched by TCS 

when reactivated, poll application TCT 

for work 
get parameter list address 
process FINDQ parameter list 



WRITEQ — WRITE A MESSAGE TO TERMINAL (S) 

The WRITEQ macro instruction causes a message to be sent to a speci- 
fied terminal and, optionally, a user's response to be read from that 
terminal. 



r 

(Name 

h 



j Operation j Operands 
-+ +- 



[symbol] 




relative line number-value 
, area- addr, length- value 

INTRPT= (Y)l f~, BREAK= 



pi NT RPT=Qj ['' 
[ ,COMPOUT= value] 



f", TRNSOUT^ i N \1 



r s n»}] 

T,TRNSIN=|N 



l,COMPIN=value] 



relative line number 

specifies relative line number of entry (or slot) in application's 
TCT associated with terminal to which message is being sent; when 
register notation is used, specified register must contain (binary) 
relative number in two low-order bytes. 

The relative line number can be found in either (A) the paramet- 
er list generated by a previous FINDQ (addressability to this list 
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can be established by using, as a base register, the pointer that 
is pointed to by register 1 and the DSECT CHAFNQ) or (B) the com- 
munication area of any external interruption-processing routine 
that may have been written by the application program (see INTRPT 
option below) . 



area 

specifies address of first byte of output message; byte preceding 
location should contain length of output message - 



length 

specifies number of bytes to be written to terminal; when register 
notation is used, specified register must contain (binary) message 
length in two low-order bytes; value must not exceed 4080 bytes. 

INTRPT 

specifies if external interruptions (with external message number 
127) are to be generated and queued on application's TSI by system 
on completion of write operation or, if response option is used, on 
completion of read operation. Specification of this operand will 
also affect any subsequent I/O operations, unless those operations 
specify different options. Y indicates external interruptions are 
to be generated; in this case the application program can process 
interruptions. N indicates no external interruptions. When N is 
specified, a subsequent FINDQ must be issued to locate any com- 
pleted WRITEQ or a WRITEQ with response. 

Default: Initially N; when this option has been changed, however, 
the default thereafter will be either Y or N f depending on the most 
recently issued READQ or WRITEQ in which the INTRPT option has been 
explicitly specified. 

BREAK (only for terminals having hardware break-feature) 

allows message to be written to terminal even if previous reads or 
writes are in process; current I/O operation will be interrupted 
and terminated. Y indicates this message should interrupt any cur- 
rent I/O operation. N indicates that if terminal is in read- or 
write-state when WRITEQ is executed, no breaks are allowed; busy 
signal is returned. If the break option is specified for a write 
issued to a terminal that does not have the hardware break facili- 
ty f results will be unpredictable. 

Default: N 

COMPOUT (for IBM 1050 system only) 

specifies decimal value indicating type of 1050 unit to be used as 
output; if register notation is used, low-order byte of specified 
register must contain the desired value. 

Value Unit type 

1 printer 1 (keyboard) 

2 printer 2 

3 punch 1 

4 punch 2 

9 any or all output components 

Default : COMPOUT=l 
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TRNSOUT 

specifies whether output string text will be translated from EBCDIC 
to line code using standard translation table for the device. Y 
indicates standard translation; N no translation. If N is speci- 
fied, text string will be sent over the line as it exists in the 
message area. 

Device Unit type 

1050 PTTC/8 unfolded 

2741 PTTC/8 unfolded 

2741 CORRESPONDENCE unfolded 

teletypewriter ASCII 

Default : TRNSOUT=N 

RESP 

specifies whether response is expected immediately after writing 
output message. Y indicates response is expected after WRITEQ and 
both write and read operations are to be initiated? N no response 
expected. 

Default : N 

COMPIN (only for WRITEQ to 1050 system with RESP=Y) 

specifies decimal value indicating type of 1050 unit from which 
response is expected; if register notation is used, low-order byte 
of specified register must contain binary form of value. 

Value Unit type 

5 keyboard 

6 reader 1 

7 reader 2 

any input component 

Default : COMPIN=5 

TRNSIN (only for WRITEQ with RESP=Y to 1050 system) 

indicates if input text string will be translated from line code to 
EBCDIC (folded), using appropriate translation table defined under 
TRNSOUT. Y indicates input line code will be translated; N, no 
translation and input message will be in buffer in line code form. 

Default : TRNSIN=Y 

INITALIZATIQN : Address of save- area must be in register 13. 

CAUTION : This macro instruction may be used only in an MTT application 
program; if break option is sent to device that does not have the hard- 
ware break facility, results will be unpredictable. 

EXECUTION : When the WRITEQ routine receives control, register 1 points 
to a pointer to a parameter list (containing the WRITEQ parameter speci- 
fications) generated in the issuing program's PSECT. The DSECT, CHAWRQ, 
describes this list. The WRITEQ routine checks the entry (or slot) in 
the application TCT pointed to by the specified relative line number. 
The associated device number is tested for validity; if valid, the sta- 
tus byte of the application TCT slot is examined for work indications. 
If there is an indication that an attention key has been hit or a pre- 
vious I/O operation is still in progress, return codes are set and then 
control returns to the application program. If the break option had 
been specified, and a previous read- I/O operation was found, the pre- 
vious operation is canceled and the WRITEQ message length is checked. 
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The WRITEQ request and associated options are posted in the applica- 
tion TCT slot and control is passed to the terminal communication sub- 
processor to initialize the I/O operation via the ATCS macro instruc- 
tion. WRITEQ then checks for any attention interruptions that may have 
occurred between the first check and the issuance of start-I/O TCS. If 
an interruption was received, the I/O is not initiated and the appropri- 
ate return code is passed to the application program. If no interrup- 
tion was received, an attempt is made to start I/O for a channel pro- 
gram. If successfully initiated, a WRITE CCW and, if RESP=Y, a READ 
CCW, have been placed on line to that device. Control is then returned 
to the issuing program before those CCW operations are completed with a 
return code of 00 in register 15. 

On subsequent execution of the channel program, the output message 
will be transmitted and, if RESP=Y, the terminal will immediately be put 
in the read state, and an input line will be read into the buffer. Com- 
pletion of the write/read operation will be signaled by posting the app- 
lication TCT slot and, optionally, by system generation of an external 
interruption of the task's TSI. 

Return Data : Control is returned to the issuing application program, 
with a code set in the low-order byte of register 15. 

Code Significance 

00 normal return 

04 invalid relative line number (not connected to application) 

08 busy, previous READQ or WRITEQ not completed (this return 
will not occur when using break option) 

0C attention interruption received from terminal 

10 solid error during start-I/O 

14 message length exceeds 4080 bytes 

The write operation will be initiated by this macro instruction only 
when the return code = 00. For RC=0C, the attention interruption indi- 
cation will be cleared. 

PROGRAMMING NOTES : The implied maximum length of any response message 
is the buffer length specified by the MTT command that enabled the app- 
lication task. Any characters transmitted beyond this length are 
truncated. 

The actual message length and its location are returned to the issu- 
ing program when the message transmission is complete; they can be found 
in a parameter list associated with either an external interruption or 
the FINDQ macro instruction. 

When the translation tables do not apply, an application program may 
apply its own translation function. In such cases, the TRNSL=N option 
should be specified and the application translation function should be 
applied against the input recorded in the buffer. If the RESP option is 
specified, and the INTRPT option was specified, no interruption will 
occur until the subsequent input is completed; the next return from 
FINDQ for this terminal will indicate "message in, complete. " 

When a WRITEQ macro instruction is executed, a copy of the output 
message will be made by the system for transmission. Therefore, it is 
not necessary for the issuing program to retain the original message 
after successful execution of the macro instruction. 
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A WRITEQ with the response option is a more efficient procedure than 
issuing separate WRITEQ and READQ macro instructions; a prompting mes- 
sage can be issued; the terminal will be in the read-state and input can 
be entered. 

If INTRPT=Y is specified, the application program must have used the 
SEEC and SIR macro instructions to set up a routine to service the 
external interruptions that indicate completions of read operations. 
External message number 127 should be specified with SEEC. (See also 
"Processing External Interruptions" under "Application Program 
Processing.") 

Any buffer space assigned by a READQ or WRITEQ to the device asso- 
ciated with the application TCT slot is released automatically by subse- 
quent execution of READQ, or WRITEQ (with or without the response 
option). However, if the input data is processed, but further READQ or 
WRITEQ processing is delayed for some reason, the application program 
can release buffer space by issuing CLEARQ. READQ and WRITEQ do not 
clear work indications; only FINDQ and CLEARQ will clear them. 

The channel program will transmit the message, as it is in the mes- 
sage area, using the specified translation. It is not necessary, on 
1050 terminals, to put addressing, polling, and EOB characters into the 
message. The user program must, however, provide the CR if necessary. 
Furthermore, if the message is to be printed as multiple lines, the 
issuing program must insert a CR character to end each line, followed by 
sufficient idle characters to allow the carriage- return action to be 
completed, before continuing with the text string in the next line. 

Use of L- and E-Forms ; The L-f orm macro instruction results in a macro 
expansion consisting of only a parameter list. The name field is manda- 
tory in the L-forra; it is used by the E-form to locate the parameter 
list. Examples: 

LFORM WRITEQ , MSGOUT, RESP=Y,MF=L (relative line-number length 

not specified) 

EFORM WRITEQ (3) , , (4) , MF= (E,LFORM) (area not specified) 

The L-forra established a parameter list, defining the message-output 
area (MSGOUT) and specifies the RESPONSE option. The E-form assumes the 
message has been placed at MSGOUT. Register 3 contains relative line 
relative line number and register 4 contains the message length. 
Omitted I-form operands assume the value established by the L-form 
(e.g., the E-form macro above does not default to RESP=N) . 

EXAMPLE ; FINDQ indicates that a terminal has just logged on to use the 
application program. WRITEQ, with a response option, is then issued to 
prompt that terminal for input that will be read into a buffer. If the 
write, with response option, is successfully initiated, the application 
program continues to poll the application TCT for additional work. 

When the initiated channel program is executed, "ENTER APPROPRIATE 
INPUT" will be displayed at the terminal, terminal will be placed in the 
read status, and an input line will subsequently be read into the 
buffer. 

*** locate terminal ready to work 

*** 

POLL FINDQ 

B ABC(15) branch based on return code 

ABC 
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NITCON terminal initially connected to 
application program; RC=08 



NITCON 



TBL 



I* 2,0(1) get address of FINDQ parameter list 

LH 6,8(2) load relative line number of initially 

connected terminal, from FINDQ 
parameter list, into low-order 
byte of register 6 

WRITEQ (6) , PRMPT,LNGTH,N, , ,TRNSOUT=Y,RESP=Y, , Y 

B TBL(15) 

B POLL successful I/O initiation 



| LNGTH DC AL2(L f PRMPT) length of output message 
PRMPT DC C" ENTER APPROPRIATE INPUT' 
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APPENDIX A: APPLICATION TERMINAL CONTROL TABLE ENTRY 



An entry (or slot) in an application's terminal control table (TCT) 
is assigned to every user connected to an application program. The 
layout of a typical TCT entry is shown below. Application programs 
indirectly scan these entries (via the MTT macro instructions: READQ, 
WRITEQ, FINDQ, etc.) to determine if terminals have requested services, 
A DSECT (CHATCT) is available for symbolically addressing fields in the 
TCT entries; it is described in System Control Blocks . 







1 



12 



14 



15 



16 



24 



LOCK 


STATUS 


MESSAGE 
LENGTH 


VM 

DATA 

ADDRESS 


FIRST 

TIOCB 

ADDRESS 


RELATIVE 
LINE NO. 


FLAG 
BYTE 1 


FLAG 
BYTE 2 


CONTROL 
CHARACTERS 
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28 



29 



32 



34 



36 



40 



41 



42 



44 



48 



TDE 
ADDRESS 


DEVICE 
TYPE 


WORK 
FIELD 


PHYSICAL 

DEVICE 

ADDRESS 


SYMBOLIC 

DEVICE 

ADDRESS 


REAL 

BUFFER 

ADDRESS 


RETRY 
COUNT 


CONTROL 
FLAG 


NOT 
USED 


TSI 
POINTER 



TCT Entry (48 bytes) 

Status-byte settings (set by TCS routine) are: 

Hex code Meaning 

X^O 1 prepare CCW indicator bit 

X'40 1 read required bit 

X f 20' buffer overflow 

X'lO 1 PCI bit 

X'OS 1 two-page data area 

X'O** 1 supervisor page for write data 

X f 02 f complete I/O bit 

X'Ol 1 halt I/O flag 

FLAG BYTE 1 — (set by macro instruction SVCs) 

Hex code Meaning 



X^O 1 
X f 40 f 
X f 20 f 
X'lO' 

x'os 1 

FLAG BYTE 2 
Hex code 



read operation 
write operation 
write/response operation 
clear operation 
free operation 

- (set by macro instruction SVCs) 

Meaning 



X^cr interruption required on task 
X'HQ* translate on in messages 

X^O 1 translate on out messages 
X'lO' break to be issued 
control characters 
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DEVICE TYPE 


Hex code 


X 1 


00 ■ 


X 1 


01 • 


X 9 


02 1 


X' 


03 • 


X 1 


04 f 


WORK 


BYTE 


Hex code 


X' 


180' 


X* 


40" 


X 1 


20" 


X 1 


10 • 


X - 


08 1 


X' 


04' 


X 1 


02 • 



Meaning 

slot available mask 
1050 PTTC/8 
2741 CORRESPONDENCE 
2741 PTTC/8 
teletypewriter ASCII 



Meaning 

message in 

message out 

attention 

initial connection 

unrecoverable error 

negative polling response 

buffer overflow flag 
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APPENDIX B: MACRO INSTRUCTION VALUE MNEMONICS 



Value mnemonics help the user remember the forms a particular operand 
may assume. The value mnemonics used in TSS/360 publications are: 

relexp 

addr 

addrx 

addx 

integer 

absexp 

value 

text 

code 

symbol 

characters 

name 

specsym 

alphnum 

In macro instruction descriptions, each positional operand is speci- 
fied by a meaningful name hyphenated with a value mnemonic, as 
illustrated: 

(Name (Operation [Operand | 

t. + + 1 

| [ symbol ] | EXAMPLE (name-value mnemonic | 

L_ . X L . . . ._ . . J 

Each keyword operand is specified by the keyword, an equal sign, and 
a value mnemonic, as illustrated: 

r T — . r _. . .- — _. . . . . 1 

| Name [Operation) Operand | 

j. + _. |. „_ _. i 

| [ symbol ) | EXAMPLE |KEYWI= value mnemonic I 

L . ... X X . . . . i 

One or more operand forms may be substituted for each value mnemonic. 
For example, the value mnemonic, relexp, denotes that a relocatable 
expression may be written as the operand form? the value mnemonic, addx, 
specifies that an explicit address or an implied address may be written. 

The 10 operand forms are: 

relocatable expression 

register notation 

explicit address 

implied address 

symbol 

decimal integer 

absolute expression 

code 

text 

characters 

data set name 

special symbol 

alphameric characters 
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Operand 
Forms 








Value M 


nemonics 














relexp 


absexp 


addr 


addrx 


addx 
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symbol 
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INDEX 



ABEND 6 

addressability, establishment of, for 
CHAFNQ 14 

example 16 
CHATII 8 

example 16 
administrator, MTT 

authority code requirement 1 
definition of 1 
interaction with 

application program 6 

user terminals 2 
keyboard 6 

privilege - class requirement 1 
AETD macro instruction , use of 7 
application program 
ABEND 6 
activation of 4 
administration 6 
coding consideration 13 
commands defined by 3,6 
commands, TSS/360, use of 2 
communication with 

MTT administrator 6 

users 2,7,8 
connecting to 1,8 
control blocks 5 

data; translation, processing 11 
definition of 1 
disconnection procedure 3, 6 
documentation requirements 2 
editing 

input 11 

output 11 
example of 3 

external interruption processing 9 
functions 3 

inhibiting interruptions 10 
initialization procedure 8 
input parameter requirements 2 
interaction with 

MTT administrator 6 

users 8 
interruption servicing 

asynchronous 6 

external 8 
I/O processing 8 
locating user terminals 8 
LOGOFF, actions 6 
name of 4 
number of users 4 
passing control to 5 
processing 3 
processing modes 

interruption mode 8 

mixed mode 10 

polling mode 8 
processing steps 3 
reading and punching cards 13 



return to TSS/360 6 
requirements for input 

parameters 2 
use of 1 

use of TSS/360 commands 2 
writing application program 8 
ASMMAC (see macro instruction library) 
asynchronous interruption 6 
ATCS system macro instruction, use 

of 15,30 
attention interruption 
bit (see FNQATN) 
from MTT administrator's 
terminal 12 

standard prompting 7 
from users* terminals 12 
application - defined 
prompting 7 
methods for detecting 

FINDQ return code 13 
indicator in FINDQ parameter 

list 13,18 
indicator in TCT 12 
servicing routine 12 
authority code; MTT administrator f 
system programmer 1 

BEGIN command, format 2,3 
break, hardware feature 13 
break option (see WRITEQ macro 
instruction) 

buffer 
area 

allocation 8,14,25,31 
release 8,25,31 
virtual storage address 10 
page 

establishment 5 
release 5 
slot 

creation 8,25,31 
release 15,25,31 
busy condition 11 
(see also return codes for CLEARQ, 
READQ, WRITEQ) 

card punch, output from application 

program 13 

(see also READQ, WRITEQ) 
card reader, input to application 

program 13 

(see also READQ, WRITEQ) 
CCW (see channel command word) 
CHAFNQ (see DSECTs) 
CHANGE system macro instruction, use 

of 5 
channel command word (CCW) 24,30 
characters, functional 11,12 
character translation tables 
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standard 11 

(defined by application program, 
see READQ, WRITEQ) 
CHATII (see DSECTs) 
CLEARQ macro instruction 14 
interruption of 12 
use in mixed mode processing 10 
clear terminal device status (see 

CLEARQ) 
commands 

BEGIN 2,3 

definition of by application 

program 3 
LOGOFF, use of 6 
LOGON, use of 1,2 
MTT 4-6 
COMAREA (see communication area) 
communication area 
locating 9 
use of 9 

(see also FREEQ, READQ, WRITEQ) 
communication between 

application program and its 

users 8 
application program and 

administrator 6 
administrator and application 
users 6 
completion of I/O 9 
CONN system macro instruction, use 

of 5 
connection to 

MTT application program 1,20 
TSS/360 task, standard 1,20 

DCON system macro instruction, use 

of 5 
defining commands 2 

example command set 3 
delta data set 4 
device types 10,11,19 

1050 11,12 

2741 11,12 
DIR macro instruction, use of 10 
disconnecting users 11 
documentation 

requirements for application 
program 2 
drop a terminal device 
(see FREEQ) 
DSECTs, use of 

CHACLQ 14 

CHAFNQ 18,9 

example 16,22,28 

CHAFRQ 21 

CHARDQ 24 

CHATCT 33 

CHATII 10-11 
example 16 

CHAWRQ 29 
dummy sections 13 

(see also DSECTs) 



external interruption 
attention indication 



12 



creating 8 

initial connection indicator 8 
I/O completion indicator 9 
message number 9 
option, READQ 22 
option, WRITEQ 27 
processing 9 
editing, application program 11 



FINDQ macro instruction 17 

parameter list (CHAFNQ) 18 
find terminal requiring work 
(see FINDQ) 

FNQATN (attention interruption flag) 
(see also FINDQ macro instruction, 

parameter list flag byte, bit 1) 
functional characters (CR, EOB, EOT, 

IL, XOFF) 11 
FREEQ macro instruction 20 

ICB (see interruption, control block) 
initiate read operation to terminal 

(see READQ) 
input messages 

editing by application program 11 

termination of 11 
input parameters 

definition of 2 

processing of 11 
inhibiting interruptions 10 
initial connection 8 
initialization procedure 8 
I/O (input /out put operations) 

buffer slots 8 

completion 9,10 

initialization 8 

processing 8 

(see also READQ, WRITEQ) 
interruption, 

asynchronous 6 

control block for (ICB) 9 

external 8 

option for 
READQ 23 
WRITEQ 28 

processing mode 8 

servicing routine, creation of 9 

synchronous (see interruption, 
external) 
interruption mode processing, 

definition of 8 

detection of 

initially connecting 

terminals 8 
I/O completion 9 

election of 12,23,28 

examples of 16 

Keyboard , locking of 4,6 

line code 22,29 

line number (see relative line number) 

logical disconnection 21 

(see also FREEQ) 
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LOGOFF command 6 

LOGON command, function of 1 

macro instruction library 14 
(see also CLEARQ, FINDQ, FREEQ f READQ f 
WAIT, WRITEQ) 
MCB (see message control block) 
message address for 

input message (see FINDQ) 

output message 28 
messages at 

ABEND 6 

logical disconnection 5 f 21 

LOGOFF 6 
message code 127, interruption for 

(see external interruption) 
message control block (MCB) 9 
message length 

actual 30 

implied maximum 25,30 

location of 25, 30 

restriction, for teletypewriter 20 

specification of (see WRITEQ) 
message- in completion 10,18 
message number (see external 

interruption, message number) 
message-out completion 10,18 
migration algorithm, drum-to-disk 4 
mixed mode processing, 

definition of 10 

example of 15,16 
multiterminal status control block 

(MTSCB) 5,26 
MTSCB (see multiterminal status 

control block) 
MTT (see multiterminal task) 
MTT administrator (see administrator, 

MTT) 
MTT application program 
(see application program) 
MTT command U 

restriction, one per task 5 
MTT macro instructions 1 
(see also CLEARQ, FINDQ, FREEQ, READQ, 
WAIT, WRITEQ) 
multiterminal task (MTT) 

buffer requirements for 5 

creation of 1 

definition of 1 

control blocks for 5 

number of users 5 
reason for creating 1 

versus standard TSS/360 task 1 

output message 

copy of (see WRITEQ) 
editing of 11 
termination of 11 

page stealing 4 
parameter list 

(see CLEARQ, FINDQ, and DSECTs) 
physical disconnection 6 

(see also FREEQ) 

polling mode; processing of 



initial connections 8,11 

examples 18,21 
I/O completions 9,11 

examples 16,19, 22,26 
(see also attention interruptions; 
mixed mode processing) 
polling the TCT 10 
posting (see FINDQ) 

privilege class, MTT administrator 1 
processing external interruptions 9 
prompting; by application program, 
interruption servicing routine 6 
prompting characters, TSS/360 6 

RAE macro instruction, use of 10 
READQ macro instruction 21,1 
read status 5,21,23,29 
recursion 10 
relative line number 

assignment 22 

example 19 

locating (see CLEARQ, FINDQ, FREEQ, 
READQ, WRITEQ) 
response option, for WRITEQ 

macro instruction 29 
response time at ABEND and LOGOFF 6 
returning from application program 5 

SAEC macro instruction, use of 6 
SAI macro instruction, use of 10 
save-area address, requirement for 
(see CLEARQ, FINDQ, FREEQ, READQ, 

WRITEQ) 
schedule table entry level 5 
SEEC macro instruction, use 

of 15,25,31 
(see also processing external 

interruptions ) 
SIR macro instruction, use 

of 15,25,31 
(see also processing external 

interruptions ) 
SVC (supervisor call) 26 
SYSIN/SYSOUT terminal 5,6 
system programmer authority code 1 

table driven scheduler 4 
task 

multiterminal, conversion to (see 

MTT command) 
standard TSS/360, establishment of 
(see LOGON command) 
task status index (TSI) 6 
TCS (see terminal communication 

subprocessor) 
TCT slot (see terminal control table) 
teletypewriter terminals 11,12 
terminal communication subprocessor 

(TCS) 24 
terminal control table (TCT) 

clearing of (see CLEARQ, FINDQ) 
DSECT 33 
entry in 33 
posting of 8,24 

(see also READQ, WRITEQ) 
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terminal interruption parameter list 

CCHATII) 9-10 
terminating application program 

processing 5 f 21 
translation (see character translation 

tables) 
TSI (see task status index) 

users, application program 
connecting 1 
command set 2,3 
disconnecting from 11 
interaction 2 
number 4 9 5 
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work byte 

clearing of byte 
CLEARQ 15 
FINDQ 17 
location of (see terminal control 

table, entry in) 
posting of by 
READQ 24 
WRITEQ 29 
settings and meanings 34 
work indications (see work byte, 

settings) 
work status (see work byte) 
write a message to terminal (see 

WRITEQ) 
WRITEQ macro instruction 27,1 



WAIT macro instruction 26,1 
wait for terminal stimuli 

(see WAIT) 
wait status 25 



1050 system 10,11 

(see also READQ, WRITEQ) 
2741 terminal 10,11 

(see also READQ , WRITEQ) 
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